home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / sleep.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  49 lines
  1.  
  2. SLEEP(3)                   UNIX Programmer's Manual                   SLEEP(3)
  3.  
  4. NNAAMMEE
  5.      sslleeeepp - suspend process execution for interval of seconds
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<uunniissttdd..hh>>
  9.  
  10.      _u_n_s_i_g_n_e_d _i_n_t
  11.      sslleeeepp(_u_n_s_i_g_n_e_d _i_n_t _s_e_c_o_n_d_s)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The sslleeeepp() function suspends execution of the calling process until ei-
  15.      ther the number of seconds specified by _s_e_c_o_n_d_s have elapsed or a signal
  16.      is delivered to the calling process and its action is to invoke a signal-
  17.      catching function or to terminate the process.  The suspension time may
  18.      be longer than requested due to the scheduling of other activity by the
  19.      system.
  20.  
  21.      If a timer is already running on the process its state is saved.  If the
  22.      value _s_e_c_o_n_d_s is more than or equal to the remaining clock time for the
  23.      saved timer, the sleep time is set to the remaining clock time.  The
  24.      state of the previous timer is restored after _s_e_c_o_n_d_s has passed.
  25.  
  26.      This function is implemented using setitimer(2);  it requires eight sys-
  27.      tem calls each time it is invoked.  A similar but less compatible func-
  28.      tion can be obtained with a single select(2);  such a function would not
  29.      restart after signals, but would not interfere with other uses of
  30.      setitimer.
  31.  
  32. RREETTUURRNN VVAALLUUEE
  33.      If the sslleeeepp() function returns because the requested time has elapsed,
  34.      the value returned will be zero.  If the sslleeeepp() function returns due to
  35.      the delivery of a signal, the value returned will be the unslept amount
  36.      (the request time minus the time actually slept) in seconds.
  37.  
  38. SSEEEE AALLSSOO
  39.      setitimer(2),  sigaction(2),  sigsuspend(2),  alarm(3),  pause(3),
  40.      usleep(3)
  41.  
  42. SSTTAANNDDAARRDDSS
  43.      The sslleeeepp() function conforms to .
  44.  
  45. HHIISSTTOORRYY
  46.      A sslleeeepp() function appeared in Version 7 AT&T UNIX.
  47.  
  48. BSD Experimental                 June 4, 1993                                1
  49.